home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 12 / Mac Magazin and MacEasy Magazine CD - Issue 12.iso / Sharewarebibliothek / DFÜ / Internet / _Helfer-Programme / InterSLIP Timer v. 1.4.2 ƒ / Read Before Launching! < prev   
Text File  |  1995-07-07  |  12KB  |  132 lines

  1.                                                                     InterSLIP Timer v. 1.4.2
  2.                                                                              © 1995 by Eric Preston
  3.  
  4. InterSLIP Timer is a utility application to be used with InterSLIP that allows you to keep track of how much time you spend on your SLIP account.   Version 1.4 has a globally floating window that will always be in front of other windows, even if InterSLIP Timer is running in the background.  There is now a menu option that will import the cumulative time and preference settings from version 1.2 or greater.  This should make upgrading painless.
  5.  
  6. InterSLIP must be properly installed on your computer for InterSLIP Timer to work.  InterSLIP Timer requires System 7.0 or later.  The globally floating window requires System 7.1 or greater.
  7.  
  8. What it does
  9.  
  10. When you launch by double-clicking, a small, draggable timer window appears under the Trash.   By default, this is a globally floating window that will always be visible above all other applications.  The globally floating window will only work with System 7.1 or greater.  If you use earlier versions of System 7, a normal window will be substituted.  When the timer window is dragged to a new position, the new position is saved and becomes the default position the next time the timer is launched.  The blue numbers, on top, display the time for the current session, while the red numbers, below,  record cumulative time.  The cumulative time can display cumulative time for the current day, cumulative time for the month beginning on a day you select, or cumulative time since you last manually cleared the register.  By default, the cumulative time keeps incrementing until you manually clear it.   By clicking on the cumulative time in the timer window, the display will toggle between cumulative for the day ( displayed like this:  00:00:05 ) or cumulative total/month (displayed like this:  00:00:05 ).  Cumulative times and other settings are automatically saved once per minute to provide some protection against loss of data should the computer crash during a timed session.
  11.  
  12. The Menus
  13.  
  14.   The File Menu:
  15.  
  16. You can initiate your InterSLIP session either by selecting "Begin Session" from the InterSLIP Timer file menu or by connecting using the InterSLIP control panel.  InterSLIP Timer waits patiently until InterSLIP signals that the connection is established, then begins to time your session.  You can use the start of the timer to confirm that your connection is established.  Selecting "End Session" from the File menu, breaks your InterSLIP connection and turns the timer off.   Selecting  "Clear Monthly" will terminate your session and set monthly cumulative time to zero.   Selecting  "Clear Daily" will terminate your session and set daily cumulative time to zero.   Selecting Preferences... will open the Preferences dialog (see below).  Selecting "Quit,"  terminates your InterSLIP session and quits the program.
  17.  
  18.   The Upgrade Menu:
  19.  
  20. The Upgrade menu can be used to update preferences and cumulative time data from a previous version of InterSLIP Timer.  When "Update prefs"  is selected, the current drive is searched for previous versions of InterSLIP Timer.  The new version and the old version must be on the same drive.  If you have multiple hard drives, be sure that both versions are on the same drive when you upgrade.  If version 1.2 or greater is found, the cumulative time and settings data will be copied to your new version.  If you have more than one copy of old versions of InterSLIP Timer, your new version will be upgraded from the first old version that is found.  So, it is wise to make sure that you have only one old version on the drive with v. 1.4.2 at the time you upgrade.  
  21.  
  22. Shortcuts
  23.  
  24. There are four shortcuts to save trips to the menu bar.  The timer window has four "Hot Spots"  in the corners.  The upper left Hot Spot, when clicked, will Begin a session.  The lower left will End the session.  The lower right spot will Quit.  The upper right spot will open the Preferences dialog.  
  25.  
  26. The Preferences Dialog
  27.  
  28. If you check Auto Clear in the Preferences dialog,  the cumulative time will automatically clear on the day of the month that you choose (first day of the month is the default).  The Preferences dialog allows the day for Auto Clear to be changed and also displays the previous month's total usage.  This is handy if you are billed by your provider by monthly usage and you want to know how much you have used.  
  29.  
  30. If "Auto Launch" is checked, InterSLIP Timer will automatically signal InterSLIP to connect to your currently configured host the next time you launch InterSLIP Timer.  If "Display Daily" is checked, the timer window will display the daily cumulative time by default each time you launch.  Cumulative times can be cleared from the Preferences dialog.  If "Close Window when Idle" is checked, the timer window will only appear when your SLIP connection is active.  
  31.  
  32. If "Hide Hot Spots" is checked, the hot spots will not appear on the timer window.  This is purely a cosmetic change and the hot spots will continue to function.   I've found that new users prefer to have an indication of the hot spots on the window, while experienced users like the plain window.  Now it's your choice.  
  33.  
  34. By default, Global Floating window is selected if you are using System 7.1 or greater.  If you prefer a normal window, uncheck this option.  Since the type of window is fixed at launch time, changes in this option will not take effect until the next time that InterSLIP Timer is launched.  If you use a version of system software earlier than System 7.1, you will not be able to check the global floating window option.  
  35.  
  36. Finally,  some users like an audible confirmation that a connection has been made or broken.  Checking "Beep on Connect" will cause a system beep when your SLIP connection has been made.  Checking "Beep on Disconnect will cause a beep on disconnnect.
  37.  
  38. The Preferences dialog has options that allow you to configure InterSLIP Timer to suit your own style of use.  Two styles are common:
  39.  
  40. Active:
  41.  
  42. InterSLIP Timer is used as the primary means for establishing and terminating SLIP sessions.  The timer is opened and closed with each session.  "Auto Launch" is often handy for this style of use since double-clicking on the timer also connects you to your internet provider automagically.
  43.  
  44. Passive:
  45.  
  46. InterSLIP Timer is run passively in the background continuously to time sessions whenever they occur, but the SLIP connection is usually made by another application (Mosaic, for example ).  In this case, "Hide Window when Idle" makes the application inconspicuous but there when you need it.
  47.  
  48. The Deal
  49.  
  50. InterSLIP Timer v. 1.4.2 is  shareware. If you find that you use it a lot and feel that it is worth $10, by all means send it. If you feel like sending a nice letter or postcard, do that. If you want to send a shareware product of your own, please do! If you don't feel like sending anything, don't send anything. There are no annoying registration dialog boxes full of accusatory language getting in your face or anything like that. 
  51.  
  52. Send your cash (best method outside the US), checks (US$ drawn on a US bank), postal money orders, postcards, letters, disks, bug reports, etc., to:
  53.  
  54. Eric Preston
  55. 23547 Clark Dr.
  56. Philomath, OR 97370
  57. USA
  58.  
  59. Internet email:    ericpresto@aol.com
  60. America Online:    EricPRESTO
  61.  
  62. If you let me know your email address, I will acknowledge receipt of your shareware contribution.
  63.  
  64. Just for Fun
  65.  
  66. Can you find the undocumented features?  There are two undocumented features in v. 1.4.  One was introduced with v 1.3 and a second with 1.4.  They are functional and not purely cosmetic.  You do not need to open the program with ResEdit to find them.  In fact, opening the program won't help at all.  Let me know, if you think you've discovered them.  Users who register get the answer.
  67.  
  68. Limitations on Distribution
  69.  
  70. InterSLIP Timer is copyrighted to Eric Preston, 1995, and may not be sold or distributed for profit in any form, either with other products (commercial, shareware, or freeware), or in shareware/freeware collections sold for profit, without my prior written consent. InterSLIP Timer may be distributed freely provided it is distributed in a non-profit manner, and is provided in its original unmodified form. However, please notify me if it is to be included in non-profit collection on disk, CD ROM, or other media.
  71.  
  72. Acknowledgements
  73.  
  74. Many thanks to Matt Slot for "appe Windows 2.0" which provides the mechanism for the global floating window.  Hiroshi Lockheimer graciously helped me through several issues in implementing the window.  Richard Lesnick caught a preferences dialog bug in version 1.2 and once again in 1.4.
  75.  
  76. Thanks to all for your help.
  77.  
  78. Disclaimer
  79.  
  80. The author makes no warranties, either express or implied, regarding InterSLIP Timer. Use of InterSLIP Timer is at your own risk. The author claims no liability for data loss or other problems caused directly or indirectly by InterSLIP Timer.
  81.  
  82. YetAnother Timer and MacPPP Timer
  83.  
  84. If you do not use InterSLIP, but otherwise have use for the features in InterSLIP Timer, download YetAnother Timer  from the Applications directory at info-mac or any of its mirrors.  It has all of InterSLIP Timer's features except the InterSLIP interface.  If you use MacPPP, try MacPPP Timer.  It's in the Communications/MacTCP directory.
  85.  
  86. Version History
  87.  
  88. Version 1.0 - January 11, 1995.  First public release .
  89.  
  90. Version 1.0.1 - January 20, 1995.  Fixed a nasty bug that caused cumulative time to be
  91.                         saved incorrectly if a second timing session was begun without first 
  92.                         quitting and  re-launching the program.
  93.  
  94. Version 1.1 - February 5, 1995.  Made automatic timer start and stop on connection a 
  95.                       bit more bullet proof.  As long as InterSLIP Timer has been launched, the 
  96.                       timer will now start/stop even if InterSLIP is launched from a different 
  97.                       application.  
  98.  
  99.                                          When timer window is dragged to a new position, the new position is  
  100.                      saved and becomes the default position the next time the timer is
  101.                      launched.
  102.  
  103.                                          Hot Spot shortcuts added to the timer window.
  104.  
  105.                                          Automatic InterSLIP connection made discretionary via file menu  
  106.                      selection.
  107.  
  108.                                          Preferences dialog added.
  109.  
  110. Version 1.2 - April 20, 1995.  Added daily cumulative timer.  Enlarged "Hot Spots".
  111.                                             Cumulative time is now saved once per minute to minimize data loss if a     
  112.                                             computer crash occurs during a session.  Additional checking at startup
  113.                       to make sure timer window is correctly placed on the current device.  
  114.                       Menu conforms with Apple Guidelines.
  115.  
  116. Version 1.2.1 - April 21, 1995.  Fixed a bug in the preferences dialog which caused the
  117.                                                  screen to be redrawn incorrectly when cumulative time was cleared.
  118.  
  119. Version 1.3 - June 2, 1995.  Added Apple Event Support.  Made Hot Spots responsive.  
  120.                                             Added "Close Window When Idle and "Hide Hot Spots"  options.  Made the
  121.                                             event loop ~ 20 times more efficient.
  122.  
  123. Version 1.4 - June 23, 1995.  Added support for global floating window. Added Upgrade
  124.                        menu.  Modified the Apple Event support code for greater compatibility
  125.                      with older macs.  Added options allowing beep on connect/disconnect.
  126.  
  127.  
  128. Version 1.4.1 - July 3, 1995.  Fixed a bug in the global window which caused the timer
  129.                         window to be drawn in the preferences dialog and in the "... about" box
  130.                         when running in B&W.
  131.  
  132. Version 1.4.2 - July 7, 1995.  Fixed a bug in the Upgrade routine.